Wolfenstein 3D  (Needs SCPU_REU)
Platform: Commodore 64
Gametype: Undefined
_________________________

This is a port of Wolfenstein 3D based on the original ID software source code release.

This port requires a C64/C128 with a SuperCPU v2 and 16MB RAM. PAL, NTSC (old and new)
as well as DREAN should be supported but it has only been tested on real PAL hardware.

The sources has been modified to allow building for 32bit targets like the MIPS CPU,
and then recompiled to 65816 code using my MIPS recompiler.

Some parts has been rewritten in 65816 assembler for better performance:

 * Main raycasting loop
 * Graphic scalers (compiled just as on i286)
 * Chunky to bitmap conversion

Wolf3D is controlled using a joystick in port 2 and the keyboard. By default it will
run in a 4-color mode and use the PC speaker sound effects. It can be switched to a
16-color FLI color mode with sample playback from the main menu. The number in the
upper left corner is the framerate.

NOTES:
  . The 16-color FLI mode is fullscreen on real hardware but VICE doesn't currently
    support the method used to create a fullscreen FLI display.
  . VICE has some issues with timing. Code to detect and work around those issues is
    included, but has only been tested on real PAL hardware and may fail on NTSC/DREAN.
  . Supporting the v1 SuperCPU could be possible, but would require dropping the double
    buffering.
  . Loading and saving game progress isn't supported.

The original shareware datafiles has been embedded in wolf3d.reu and may be extracted if desired:

dd skip=7156028 count=1156 if=wolf3d.reu of=AUDIOHED.WL1 bs=1
dd skip=7157184 count=132613 if=wolf3d.reu of=AUDIOT.WL1 bs=1
dd skip=7289800 count=27425 if=wolf3d.reu of=GAMEMAPS.WL1 bs=1
dd skip=7317228 count=402 if=wolf3d.reu of=MAPHEAD.WL1 bs=1
dd skip=7317632 count=1024 if=wolf3d.reu of=VGADICT.WL1 bs=1
dd skip=7318656 count=326568 if=wolf3d.reu of=VGAGRAPH.WL1 bs=1
dd skip=7645224 count=471 if=wolf3d.reu of=VGAHEAD.WL1 bs=1
dd skip=7645696 count=742912 if=wolf3d.reu of=VSWAP.WL1 bs=1

Running in VICE is easiest and fastest by using the REU image:

xscpu64.exe -reu -reusize 16384 +reuimagerw -reuimage wolf3d.reu -autostartprgmode 1 -autostart loader.prg

Running on real hardware can be done using an 1581/FD-2000 or compatible diskdrive by
writing the D81/D2M images to real floppy disks.

The loader is based on the "Covert Bitops Loadersystem V2.26" which supports a lot of
different hardware.

NOTE: The loader is quite flexible and will allow you to split files should you want to put
the files on different media. All you need to do is to split the files and name them like
the original but with the extension ".0", ".1", ... as I did with the wolf3d.scpu file for
the d81 distribution. You can also do the opposite and merge any split files if you decide
to put them on some mass storage device like the IDE64.

Contact:

Write to me (Mathias Roslund) at: maro [at] amidog [dot] se

History:

1.1 (2017-12-03): Optimized graphic scalers. Use shorter divides in a few places.
	Show damage by changing the border color (as we have a fixed palette and can't
	adjust the palette as on VGA). Added dirty rectangle refresh (only perform
	chunky to bitmap conversion on areas of the screen which has changed). Added
	d81 distribution. Use correct SID frequency tables on NTSC/DREAN. Fixed possible
	deadlock when switching from 16-color to 4-color mode. Various minor bugfixes
	and optimizations.
1.0 (2017-05-24): First release.
